home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 44 / Amiga Format CD44 (1999-08-26)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-10].iso / -in_the_mag- / basics / blitz / catscraplib104.lha / CATSCrapLib104.readme
Text File  |  1991-04-22  |  4KB  |  102 lines
  1. Short:        The most useful extra commands for Blitz 2 ever!
  2. Uploader:     blaze@box.net.au (Steven Cooke)
  3. Author:       CAT (Toby Zuijdveld)
  4. Type:         dev/basic/
  5.  
  6.                                /\
  7.       _   _ _  /\___ _   _    //\\__ _   _  /\_ _ /\__/\_ _   /\__/\_  _
  8.  __ _________\//\_____________/  \__________/\____/\  /\  ____/\__/\______
  9. \\_\\____   ¬\/.  ____/   ____/__/   _______   __/  \/  \/ /     \.  ____/
  10.      |   )  _//  __/__\____   \  \_____  \/    \/    \   \ \   \_/  __/__
  11.      |!  |   ¬\       \    \  \\  \    \ \\    \\    \\ \  \\ -/ \       \
  12.      |___|   //_____ //______ //__/_____ //___ //___\//_/\ //__ //DTN__ //
  13.          !___/      \/       \/         \/    \/    \/    \/   \/      \/
  14.                             aren't proud to present:
  15.  
  16.                          The CAT Scrap Lib for Blitz 2!
  17.  
  18. This new library by CAT/RST boasts of a whole 4, yes, i repeat, *4* new
  19. features, all just as useless as the other!!!  The library consists of 3
  20. statements and a function.  Here they shall be listed and described.
  21.  
  22. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  23.  
  24. Statement       :       Blink
  25. Arguments       :       number of blinks
  26. Returns         :
  27. Format          :       Blink <n>
  28. Description     :       This command will flash your LED the specified number
  29.                         of times.  However the value must be between 0 and
  30.                         100.
  31.  
  32. Statement       :       Crash
  33. Arguments       :
  34. Returns         :
  35. Format          :       Crash
  36. Description     :       This BRILLIANT command (!) will crash the computer.
  37.                         REALLY usefull for shareware programmers who can't be
  38.                         FRIDGED removing code for a special unregistered
  39.                         version, just shove the Crash command in and your code
  40.                         is completely protected to the average lamer.
  41.  
  42.                         As of version 1.04, this command is linked with the
  43.                         NoCrash command and simply will NOT work when the
  44.                         debugger is enabled.
  45.  
  46. Function        :       LEDStatus
  47. Arguments       :
  48. Returns         :       a word
  49. Format          :       word=LEDStatus
  50. Description     :       Returns a -1 if the LED is on, 0 if it is off.
  51.  
  52. Statement       :       NoCrash
  53. Arguments       :       On/Off
  54. Returns         :
  55. Format          :       NoCrash <On/Off>
  56. Description     :       Used to turn the Crash statement On or Off.  With
  57.                         NoCrash On, Crash will just send an RTS, with NoCrash
  58.                         Off, Crash will...  er...  crash!
  59.  
  60. =H=i=s=t=o=r=y=:=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  61.  
  62. v2.1    First public release.  Local areas only.
  63.  
  64. v1.04   First major release.  Fine tuned a few things here and there, added
  65.                 NoCrash command.
  66.  
  67.                 I have shortened the Crash command to use 6 bytes rather than
  68.                 about...  er...  146?
  69.  
  70. =G=e=n=e=r=a=l=-=C=o=m=m=e=n=t=s=:=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  71.  
  72. I have to be honest before Mark Sibly cracks a mental at me :) But the only
  73. bits I *REALLY* coded was the Crash statements :) The other bits came
  74. STRAIGHT from Mark Siblys' first library coding tutorial, found on BUM7.
  75.  
  76. BUT the reason for putting them in my lib was, well, no one else had yet :)
  77.  
  78. So now you can actually USE these commands, not just read about them!
  79.  
  80. And you get 2 bonus commands as well.  What value.
  81.  
  82. And the best bit is that this lib is PD and is released with the source, so u
  83. can study and marvel at it's stupidity.
  84.  
  85. Please note that the NoCrash command is the most amount of asm I've ever
  86. managed to put together myself (which explains why this lib will not get
  87. updated very often) without everything going boo-boos and I think it's right.
  88. It seems to work right.  I think it's rather efficient, for what it does, too
  89. :)
  90.  
  91. I've given my library number 102.  I read somewhere to number libs between
  92. 100-200 and I spent ages in LibMan finding a number I felt was suitable for
  93. this lib, that didn't clash or wasn't allready an ACID assigned lib, so
  94. if it does clash, please give me one that doesn't.  Someone?
  95.  
  96. Any comments (please refrain the flames:) can be sent to me (Toby Zuijdveld)
  97. at the uploader address at the top of this readme.
  98.  
  99. CYAs l8r.
  100.  
  101. =-=
  102.